WhereAmI
========

WhereAmI is a simple hybrid application example. It demonstrates the use of
HTML5 Geolocation API, implemented with Qt Quick for Symbian and with
Silverlight for Windows Phone. The example also demonstrates the use of Nokia
Maps JavaScript APIs.

The whole project demonstrates how to utilise HTML5 Geolocation API in the
following hybrid example applications:
 - Qt Quick application using QML WebView element and
 - Silverlight application using WebBrowser component. 

By hybrid application we mean in this case that a user interface implemented
with Qt Quick or Silverlight controls the HTML content, and that the
applications consist of both native UI components and HTML.

This example application is hosted in Nokia Developer Projects:
- http://projects.developer.nokia.com/whereami

For more information on implementation and porting, visit the product�s wiki
pages:
- http://projects.developer.nokia.com/whereami/wiki


1. Prerequisites
-------------------------------------------------------------------------------

 - Qt Quick basics
 - Windows Phone development basics.


2. Project structure and implementation
-------------------------------------------------------------------------------

2.1 Folders
-----------

 |                      The root folder contains the license information and
 |                      this file (release notes).
 |
 |- bin                 Contains the compiled binaries.
 |
 |- QtQuick             Root folder for the Qt Quick application project.
 |  |
 |  |- html             Contains the HTML, CSS, JavaScript and images files.
 |  |
 |  |- icons            Contains the application launcher icon.
 |  |
 |  |- images           Contains the images used by the native part of the
 |  |                   application.
 |  |
 |  |- qml              Contains the QML files of the Qt Quick application.
 |  |
 |  |- src              Contains the Qt / custom QML source files.
 |
 |- WindowsPhone        Root folder for the Windows Phone application project.
    |                   Contains the Visual Studio solution file.
    |
    |- WhereAmI         Contains the project and source files.
       |
       |- html_content  Contains the HTML, CSS, JavaScript and images files.
       |
       |- Properties    Contains the manifest and assembly info files.
       


2.3 Used APIs
-------------

In the Qt Quick application the QML WebView is used to show the HTML content.

In the Windows Phone application the WebBrowser component is used to implement
the corresponding features.


3. Compatibility
-------------------------------------------------------------------------------

 - Symbian Anna and Belle devices with Qt 4.7.4 or higher.
 - Windows Phone.
 
Tested to work on Nokia E7-00 and Nokia Lumia 800 phones. Developed with 
Qt SDK 1.2.1 and Visual Studio 2010 Express for Windows Phone.

3.1 Required Capabilities
-------------------------

 - NetworkServices
 - Location

The application can be self-signed on Symbian.


3.2 Known Issues
----------------

None.


4. Building, installing, and running the application
-------------------------------------------------------------------------------

4.1 Preparations
----------------

Check that you have the latest Qt SDK installed in the development environment
and the latest Qt version on the device.

Qt Quick Components 1.1 or higher is required.

4.2 Using the Qt SDK
--------------------

You can install and run the application on the device by using the Qt SDK.
Open the project in the SDK, set up the correct target (depending on the device
platform), and click the Run button. For more details about this approach,
visit the Qt Getting Started section at Nokia Developer
(http://www.developer.nokia.com/Develop/Qt/Getting_started/).

4.3 Symbian device
------------------

Make sure your device is connected to your computer. Locate the .sis
installation file and open it with Ovi Suite. Accept all requests from Ovi
Suite and the device. Note that you can also install the application by copying
the installation file onto your device and opening it with the Symbian File
Manager application.

After the application is installed, locate the application icon from the
application menu and launch the application by tapping the icon.

4.4 Desktop
-----------

Simply locate the index.html file from the project, e.g.
QtQuick/html/index.html, and open it in your web browser. Allow location
sharing feature if prompted.


5. License
-------------------------------------------------------------------------------

See the license text file delivered with this project. The license file is also
available online at
- http://projects.developer.nokia.com/compass/browser/Licence.txt


6. Related documentation
-------------------------------------------------------------------------------

Qt Quick Components
- http://doc.qt.nokia.com/qt-components-symbian-1.1/index.html


7. Version history
-------------------------------------------------------------------------------

1.0 Initial version.

